home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 088 / qne21.arc / QNE21.DOC next >
Text File  |  1987-11-16  |  14KB  |  289 lines
  1.  
  2.                             QUICK NEWS EDITOR v2.1
  3.                  by Scott Pazur, SYSOP of The Flea Market BBS
  4.                           Public Node:  201-446-1665
  5.                  
  6. Quick News Editor (QNExx.EXE) is just that, a simple and fast way to update
  7. your PC-Board NEWS and NEWSG files to bring the latest news to your users.
  8. The editor itself functions much the same way as PC-Board handles message
  9. entry, with the same editing commands.  Easy to use, simple to learn, and 
  10. absolutely free.  
  11.  
  12.  
  13. ============================================================================
  14. Version 2.1 - November 16, 1987
  15.  
  16. Nothing major (YET!).  I had intended on this being a major update, but free
  17. time suddenly became a thing of the past again.  Look for v3.0 to drasticly
  18. change QNE.  As for this version:
  19.  Fixed:  1.  The problem with backspacing going past the line number.
  20.          2.  The problem with line wrap not working when [I]nserting
  21.              lines.
  22.  
  23.  Changed:  1. Output!  New title line looks like:
  24.               ╔═════════════════════════════════════════╗
  25.           ════╣ November 11:  Test #1 of Beta version 3 ╠════════...
  26.               ╚═════════════════════════════════════════╝
  27.               I didn't want any lawsuits from the PCBNEWS author who says
  28.               that "the look and feel of PCBNEWS is copyright...", but
  29.               whose output is exactly the same as QNE v2.0 and below (grin)
  30.  
  31.  Added:  1.  New options (like it really needs more!) to allow 
  32.              customization of the output colors.  See the section titled
  33.              "Starting QNE" for more info.
  34.  
  35. ============================================================================
  36. Version 2.0 - August 26, 1987
  37.  
  38. Yes, line wrap is finally here!  This is the biggest addition to this 
  39. version.  The other biggie is the optional title on the news item being 
  40. edited.  You will always be prompted for a title, and if you do not want
  41. one, simply hit enter to skip the title.  Some little additions are removal
  42. of the /I option (if you haven't upgraded to 1.7 or 1.8 yet, you'll have to
  43. start all over to get the /H option to work properly).  I've added a /? 
  44. option for help with the command line options (for those of us that hate
  45. docs).  Finally, the news text is indented for a more symmetric-type 
  46. display, and the local misalignment in versions 1.7 and 1.8 is fixed.
  47. ============================================================================
  48. Version 1.9 - No such thing, don't ask me why (grin)
  49. ============================================================================
  50. Version 1.8 - July 3, 1987
  51.  
  52. Added option (/M:filename) for merge file facility.  This will take a text
  53. file and merge it into your news text.  See notes below.
  54. Also added a check for a graphics version of the header file.
  55.  
  56.  
  57.  
  58. ============================================================================
  59. Version 1.7 - June 14, 1987
  60.  
  61. Added option (/H:filename) for header file to be included in NEWS/NEWSG.  
  62. Also, an option (/I) has been added to initialize old output of QNE for the
  63. use of the header files.  This initialization MUST be done once on output
  64. produced by QNE versions 1.6 and below in order for the header option to
  65. work correctly.  See the info below on /I for more information.
  66. ============================================================================
  67. Version 1.6 - June 2, 1987
  68.  
  69. Minor fix/addition release to allow upper ASCII characters to be used when
  70. editing a NEWS file.  Had to recompile with QuickBasic instead of Turbo Basic
  71. to accomplish this.  Another strike against Turbo Basic.
  72. ============================================================================
  73. Version 1.5 - May 29, 1987
  74.  
  75. Thanx to Gary Thurlow for pointing out a bug in version 1.4 that didn't 
  76. allow the use of path\filename.  It worked fine when editing a file in the
  77. current directory, but blew up when a path longer than 8 characters was 
  78. used.  I'm happy to report that all is now well, enjoy...
  79. ============================================================================
  80. Version 1.4 - May 27, 1987
  81.  
  82. By request, added an option (/G) to eliminate ASCII graphics characters from
  83. the non-graphic output file if so desired.
  84. ============================================================================
  85. Version 1.3 - April 30, 1987
  86.  
  87. Initial release, fully functional, open for suggestions for future releases!
  88. ============================================================================
  89.  
  90.  
  91.  
  92. Starting QNE:
  93.  
  94.    QNE now has eleven possible command line switches.
  95.  
  96.         /F:filename   -   This is the non-color/graphics version of the
  97.                           file you wish to edit.  QNE will also edit
  98.                           the filename above with a "G" appended to the
  99.                           name for the color graphics version, unless
  100.                           the /N switch is specified (see below).  If the
  101.                           /F switch is omitted, QNE assumes you want to
  102.                           edit NEWS and NEWSG in the CURRENT directory.
  103.  
  104.         /C            -   Forces editing screen (your screen, not the 
  105.                           output files) into monochrome mode.
  106.   
  107.         /N            -   Causes QNE to only edit/create/update the straight
  108.                           ASCII NEWS file, and will leave the G version alone.
  109.  
  110.         /G            -   This option eliminates ANSI drawing chars from the
  111.                           non-color/graphics version of the NEWS file.
  112.                           For example:
  113.                             Without /G
  114.                                   ╔════════════╗
  115.                               ════╣ Title line ╠═══...
  116.                                   ╚════════════╝
  117.                             With /G
  118.        
  119.                               ====[ Title line ]===...
  120.  
  121.         /H:filename   -   Includes an optional header file at the beginning
  122.                           of the specified output file.  There can now be two
  123.                           versions of the header file, a straight ASCII and
  124.                           and an ANSI/graphic version.  They are distinguished
  125.                           by the "G" added to the filename of the graphic  
  126.                           file.  Both HEADER/HEADERG and
  127.                           HEADER.TXT/HEADERG.TXT will work correctly.  Only
  128.                           specify the non-graphic filename on the QNE command
  129.                           line.  It will hunt for the "G" file, and use it if
  130.                           it exists.  If it does not exist, it will use the
  131.                           non-"G" version for both NEWS and NEWSG.
  132.  
  133.         /M:filename   -   Will import a text file into the news text.  It will
  134.                           start at line 1, and MUST be less than 50 lines 
  135.                           long.  You can always [I]nsert lines before line 1 if
  136.         * SEE MERGE       desired.  Also, eventhough ANSI codes for color etc 
  137.         * FILE NOTES      will be read in correctly, due to the way QNE output
  138.         * ON NEXT PAGE    is formatted, it will probably not end up as you
  139.                           want it to.  Therefore, it is recommended that any
  140.                           merge file be straight ASCII text.  QNE will not
  141.                           check for a "G" merge file, this is not supported.
  142.  
  143.         /T:x          -   title color (default=white)
  144.         /D:x          -   date color (default=yellow)
  145.         /L:x          -   line separator color (default=blue)
  146.         /B:x          -   body(text) color (if not specified, you will still
  147.            │                             be prompted unless you told QNE not
  148.            │                             to create a graphics version 
  149.            │                             with the /N option)
  150.            
  151.            x options:  G=green  C=cyan  R=red  M=magenta
  152.                        Y=yellow   W=white
  153.  
  154.         /?            -   Provide instant command line option help.
  155.  
  156.  
  157.  
  158.  
  159.  
  160. NOTE ON HEADER FILES WITH THE /H OPTION:
  161.      
  162.      If you are just now upgrading from QNE v1.6 or less, you might run  
  163.      into a problem with the header file the first time you use v2.1.
  164.      You have two choices:
  165.                      1.  Run QNE one time WITHOUT using the /H option.
  166.                          You'll then be all initialized for future
  167.                          header inclusion.  
  168.                      2.  Start from scratch with a new NEWS/NEWSG file.
  169.  
  170.      If you have been using version 1.7/1.8/2.0, you'll have no problems.
  171.      
  172.                      
  173.  
  174. NOTES ON MERGE FILE OPTION AND FILE RESTRICTIONS
  175.  
  176.    - Just as you are limited to 74 characters per line in the editor, the
  177.      merge file is also limited to 74 characters per line.  Any lines 
  178.      longer than 74 characters will be truncated.
  179.    - When a file is merged, you will get a confirmation message in the
  180.      editor info header (i.e. "-> FILE MERGE COMPLETE <-").
  181.    - Editing after a merge will commence at the line following the merged
  182.      text.  For instance, if a 10 line text file is merged into the news,
  183.      the first line number to appear will be 11.  The merged text is NOT
  184.      displayed automatically.  You can use the [L]ist command to verify
  185.      that the file was merged.
  186.  
  187.  
  188. Examples:
  189.   
  190.           QNExx
  191.              - Will edit NEWS and NEWSG in the current directory (no /F).
  192.                If they do not exist, they will be created.
  193.              - Your screen will be in color during editing (no /C).
  194.              - Will create/edit both NEWS and NEWSG (no /N).
  195.  
  196.           QNExx /F:c:\pcb\gen\news
  197.              - Will edit NEWS and NEWSG in the c:\pcb\gen directory (/F).
  198.                If they do not exist, they will be created.
  199.              - Your screen will be in color during editing (no /C).
  200.              - Will create/edit both NEWS and NEWSG (no /N).
  201.       
  202.           QNExx /F:c:\pcb\gen\news /C 
  203.              - Will edit NEWS and NEWSG in the c:\pcb\gen directory (/F).
  204.                If they do not exist, they will be created.
  205.              - Your screen will be forced to monochrome during editing (/C).
  206.              - Will create/edit both NEWS and NEWSG (no /N).
  207.  
  208.           QNExx /F:c:\pcb\gen\news /C /N
  209.              - Will edit NEWS in the c:\pcb\gen directory (/F).
  210.                If they do not exist, they will be created.
  211.              - Your screen will be forced to monochrome during editing (/C).
  212.              - Will only edit/change NEWS, and not NEWSG. (/N).
  213.                do not exist, they will be created.  
  214.  
  215.           QNExx /F:c:\pcb\gen\news /C /N /G
  216.              - Will edit NEWS in the c:\pcb\gen directory (/F).
  217.                If they do not exist, they will be created.
  218.              - Your screen will be forced to monochrome during editing (/C).
  219.              - Will only edit/change NEWS, and not NEWSG. (/N).
  220.                do not exist, they will be created.  
  221.              - Will not use ANSI drawing chars in NEWS. (/G)
  222.  
  223.           QNExx /?
  224.              - Will list all the QNE command line options and a short
  225.                description of each one.  If you're like me, you NEVER
  226.                have documentation available when you need it.
  227.          
  228.           QNExx /F:c:\pcb\gen\news /c /h:c:\pcb\stuff\header.txt
  229.              - Will edit NEWS and NEWSG in the c:\pcb\gen directory (/F).
  230.              - Your screen will be forced to monochrome during editing (/C).
  231.              - Will include the header file c:\pcb\stuff\HEADER.TXT in
  232.                the output of NEWS, and will check for the file 
  233.                c:\pcb\stuff\HEADERG.TXT.  If it exists, this will be the
  234.                header file in NEWSG.  If not, c:\pcb\stuff\HEADER.TXT will
  235.                be used in both NEWS and NEWSG.
  236.  
  237.           QNExx /F:c:\pcb\gen\news /c /h:c:\pcb\stuff\header.txt /m:mrg.fil
  238.              - Will edit NEWS and NEWSG in the c:\pcb\gen directory (/F).
  239.              - Your screen will be forced to monochrome during editing (/C).
  240.              - Will include the header file c:\pcb\stuff\HEADER.TXT in
  241.                the output of NEWS, and will check for the file 
  242.                c:\pcb\stuff\HEADERG.TXT.  If it exists, this will be the
  243.                header file in NEWSG.  If not, c:\pcb\stuff\HEADER.TXT will
  244.                be used in both NEWS and NEWSG.
  245.              - The disk file MRG.FIL will be imported into your news text
  246.                beginning at line 1.  You can add to this, insert additional
  247.                text before this file, or just save the imported file.
  248.  
  249.  
  250.  
  251. Editing notes:
  252.    The editor now has word wrap!  You no longer have to hit enter for each
  253.    line.   Hitting ENTER on a blank line ends the line editing.  You will
  254.    then have the following choices:
  255.            A - Abort edit, restore files to original state
  256.            S - Save edits
  257.            C - Continue editing from the next line
  258.            D - Delete a line
  259.            I - Insert a line
  260.            L - List text entered thus far
  261.        or  E - Edit text in a particular line
  262.    These choices function much the same way as PC-Board's message editor.
  263.  
  264. Also:
  265.    If you didn't use the /B:x option on the command line at startup, when
  266.    the S option is chosen, and only if you are editing a color/graphic
  267.    NEWSG file, you will be asked for a color choice.  QNE will save the text 
  268.    portion of the current NEWS file in the color of your choice.
  269.  
  270.  
  271. I lied!
  272.    Sorry, this is not absolutely free as mentioned before.  If you use it,
  273.    and like it, or even if you don't like it, call my board and tell me!
  274.    Let me know if a DOOR version would come in handy, or if there's 
  275.    something you'd like added, or that it's just the thing you were looking
  276.    for, or whatever.  Just don't comment on the docs!  I never claimed to be
  277.    a writer (grin).  Anyway, I hope you find this useful...
  278.  
  279.  
  280. By:
  281.   Scott Pazur, SYSOP of The Flea Market BBS
  282.   Public Node: 201-446-1665   24hours   1200/2400
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.